home *** CD-ROM | disk | FTP | other *** search
/ Freaks Macintosh Archive / Freaks Macintosh Archive.bin / Freaks Macintosh Archives / Hacking & Misc / Mac Satellite.sit / Mac Satellite / MacSeason9 v1.7 / MacSeason9v1.7 / MacSeason9.readme next >
Text File  |  1995-08-15  |  8KB  |  168 lines
  1. Last changes: 15/08/95
  2.  
  3. This is a smartcard emulator for the Apple Macintosh. It was build using
  4. the information given in Markus Kuhn's Season7 and the 8031 assembler
  5. code in DECRYPT1.asm for the secret(?) algorithm of the BSkyB smartcards.
  6. Thanks to Markus, Ian, Joerg, M, Gabriele and the anonymous author of
  7. DECRYPT1.asm. Full source codes for Think C are included.
  8.  
  9. This software is free. If anybody charged you anything for the software
  10. itself you've been had and should demand your money back.
  11.  
  12. To build an adaptor for the Macintosh is easy. Just look up Markus Kuhn's
  13. adapter.txt. You just have to use another plug to connect it to the Mac's
  14. Mini-8 ports. (Or you solder a 25 pin socket to the interface and use a 
  15. modem cable.)
  16.  
  17. Use the following wiring:
  18.  
  19.         (PC)          (PC)        Mac
  20.     Sub-D 25-pin  Sub-D 9-pin  Mini-8
  21. ---------------------------------------------------------
  22. TxD         2               3         3    (TxD-)    transmit data
  23. RxD         3               2         5    (RxD-)    receive data
  24. RTS         4               7         -            request to send
  25. CTS         5               8         -            clear to send
  26. DSR          6               6         -            data set ready
  27. GND         7               5         4    (GND)    ground
  28. DCD         8               1         2    (HSKi)    carrier detect
  29. DTR        20               4         -            data terminal ready
  30.  
  31. DCD is used for the reset signals from the decoder by the way.
  32. This is the same wiring as the one required for DeepSpace9, another
  33. season 9 decoder for the Macintosh.
  34.  
  35. Please note: if you want to solder a mini 8 plug onto the interface and
  36. use a standard serial cable you might have to use different pins.
  37. Most serial cables cross pins 3 & 5 and pins 1 & 2, so you would have
  38. to use pin 5 for TxD-, pin 3 for RxD- and pin 1 for HSKi.
  39.  
  40. If you got the hardware set up, just start the program, it's fairly
  41. basic. Please make sure that the program uses the correct port.
  42.  
  43. What does what?
  44. Menu Crypt:
  45. Menu item "Fulltime Mode":
  46.     Usually MacSeason9 allows background tasks. This might interfere with
  47.     the timing for the decoder. If you select this menu item, MacSeason9
  48.     will run in an endless loop, NOT HANDLING ANY EVENTS!
  49.     You can exit this loop by pressing Escape, Cmd-Q, or Cmd-. on your
  50.     keyboard. You might have to hold the keys down for a while to see any
  51.     effects.
  52.     If you use Cmd-Q the program will quit and the next time you start
  53.     MacSeason9 it will start off in fulltime mode. Escape and Cmd-. (period)
  54.     will simply exit fulltime mode.
  55. Menu item "Debug":
  56.     This shows or hides a second window in which the detailed messages
  57.     between decoder and Mac will be shown. This will MacSeason9 definitely
  58.     cause to cease decoding on slower Macs!
  59. Menu item "TV Messages":
  60.     This item determines whether MacSeason9 will display the station name on
  61.     the TV set or not. When MacSeason9 displays the station, the stationname
  62.     is in the upper line, while the actual time (taken from the Mac's internal
  63.     clock) is displayed in the lower line.
  64. Menu item "Full decoding":
  65.     Not every 32-Byte message from the decoder requires an 8 Byte answer.
  66.     Whether an answer will be requested is determined by Bit 3 in the first
  67.     byte of the 32 byte message. If "Full decoding" is checked, every
  68.     message is completely decoded, whether needed or not. If it is not
  69.     checked the algorithm tries to save some time by only doing necessary
  70.     stuff.
  71. Menu item "Full display":
  72.     This is meant for slower Macs. Usually, the last command byte, the
  73.     checksum, the station and some information about the status of the
  74.     program are displayed. Without "Full display" this is minimized to only
  75.     the station name and the status.
  76. Menu item "Set Prefs…":
  77.     Here you can change the delays used by the program for internal timing.
  78.     This might be necessary if your Mac is too fast or too slow.
  79.     You can also choose which port the program should use. (Printer/Modem)
  80.     Meaning of the different delays:
  81.     Process: Delay between receiving a command from the decoder and actually
  82.         doing something.
  83.     Reset: Delay between getting a reset and sending the reset answer to
  84.         the decoder.
  85.     Byte: Delay between each single byte that is sent to the decoder.
  86.     The delays are more or less timed, so they should be the same for
  87.     almost any Mac. 0, 140, and 0 seem to produce optimum results.
  88.     The smallest possible delay on your machine would be the best solution.
  89.     The kernel counter: This is the number of times the kernel is called
  90.         before a wait-signal is sent to the decoder. Usually the kernel
  91.         function is called around 100 times. Some codes require the kernel
  92.         to be called 300+ times which results in the computer being timed out.
  93.         If MacSeason won't work on your Mac with this value set to 999
  94.         (standard value, no wait-signals are sent) try values between
  95.         50 and 300.
  96. Menu item "Shutdown…"
  97.     Here you can set the time in minutes, after which the computer will
  98.     shut down. You need of course a Mac that can be shut down via software
  99.     to use this feature. You'd better quit any other application that is
  100.     also running to avoid any data loss or other problems.
  101.  
  102. All this settings are saved when you quit MacSeason9 via the quit command.
  103. Changes are NOT saved when you use MacSeason9 to shutdown your computer
  104. either by using the "Shutdown…" menu or by pressing Cmd-Alt-Ctrl-Q.
  105. MS9 doesn't use an external file (which would be the correct Apple way to 
  106. do it) but stores the settings in the 'pref'-resource with ResID 128.
  107.  
  108. Other stuff:
  109.     - You can use Cmd-I to display the on-(TV)-screen message once with
  110.       the corresponding channel name and time.
  111.     - If you Mac supports this feature, you can shut it down using
  112.       Cmd-Alt-Ctrl-Q. This only works in fulltime mode, though.
  113.     - Pressing 'd' while in debugging mode switches between different
  114.       modes. Pressing 'h' freezes the contents of the debug window.
  115.       Pressing 'h' again resumes normal operation.
  116.  
  117. About the delays:
  118.     The most important one is usually the Reset delay. Rule of thumb:
  119.     If you switch to an encrypted channel, you will see the message "RESET"
  120.     in the small window. If this changes to "Wait for Reset" the Reset delay
  121.     is either too short or too long. The message should ideally change to
  122.     "decoding" as soon as possible. Working values seem to range from 100 to
  123.     200, depending on the speed of your Mac. The faster your computer works,
  124.     the higher the value.
  125.     
  126. Sometimes it helps to set the monitor depth to black and white on slower
  127. machines.
  128.  
  129. NOTE: IT IS ILLEGAL TO USE THIS SOFTWARE IN COUNTRIES WHERE YOU CAN
  130. OFFICIALLY SUBSCRIBE, EXCEPT IF YOU ALREADY HAVE A FULL SUBSCRIPTION.
  131. THIS SOFTWARE IS FOR EDUCATIONAL PURPOSES ONLY. I TAKE NO RESPONSIBILITY
  132. IF YOU USE THIS SOFTWARE ILLEGALY.
  133.  
  134. Enjoy,
  135.  
  136. Marc
  137.  
  138.  
  139. Latest changes:
  140. (15/08/95) v1.7
  141. Fixed latest ECM. Access to addresses $0088 and $00EE is now implemented.
  142. (14/08/95) v1.6b
  143. Implemented Subchannelcodes. Thus all Multichannels except Sky One, Sky
  144. News, Nickelodeon and Sky Soap/Travel should now be identified by their own
  145. name. Cleaned up parts of the code.
  146. (12/08/95) v1.6a
  147. Fixed implementation of nanocommand 0x0f. I hope this gets rid of the
  148. odd-time dropouts.
  149. (03/08/95) v1.6
  150. Fixed pseudonanocommand 0x0f. Thanks to Ian for the fix.
  151. (07/10/95) v1.5c
  152. Built in a new feature: Counter for Kernelroutine. This goodie is taken from
  153. Gabriele Roncolato's SAFESEX smart card emulator for the Amiga. It should help
  154. to make MacSeason more reliable on very slow Macs (i.e. 68000/8MHz).
  155. Furthermore I slightly changed the behaviour of MacSeason9 in fulltime mode.
  156. As long as the command key is held down, events get processed. This makes MS9
  157. a bit more flexible and fixes a bug with cmd-I. As long as MS9 isn't decoding
  158. events are now always allowed, even in fulltime mode. This frees up your Mac
  159. if you're switching to an unencrypted channel.
  160. (06/29/95)
  161. Reinstalled nanocommand 28.
  162. (06/15/95)
  163. Sky's $e7 ECM fixed
  164. Adult Channel ECM. They are getting nasty...
  165. (06/12/95)
  166. Some minor optimizations, plus the "TVX" station name now gets displayed
  167. correctly.
  168.